home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / fnos16a5.zip / HELP.ZIP / NNTP < prev    next >
Text File  |  1996-07-18  |  12KB  |  262 lines
  1.  
  2. nntp
  3.  
  4.         The 'nntp' commands control the operation of the Network News
  5.         Transfer Protocol (NNTP).  The nntp features are defined at
  6.         compile-time.  Two NNTP modules are available, "NNTP" which is an
  7.         NNTP client only, that stores news in a mailbox-compatible form,
  8.         and another, "NNTPS" which is a both an NNTP client and server,
  9.         that stores news articles in a form inaccessible to mailbox users.
  10.  
  11.         We first describe the "NNTP" nntp client features:
  12.  
  13.         nntp addserver <nntpserver_host> <interval> [<range>] [<groups>]
  14.           Add an NNTP news server to query every <interval> seconds for new
  15.           articles in the specified <groups>.
  16.  
  17.           <range> specifies the time-of-day limits when the queries will be
  18.           made, in the form hh:mm-hh:mm where start time precedes end time.
  19.  
  20.         Multiple 'nntp addserver' commands may be used to concatenate
  21.         groups (up to a maximum of 512 bytes).
  22.  
  23.              Example:  nntp add w5ddl.ampr.org 3600 18:00-06:00
  24.  
  25.  
  26.         nntp directory [ <News_spool_dir> [News_control_dir> ]
  27.           Display or set the spool directory for spooling news articles.
  28.           Default is /spool/mail.  Optionally set a new control directory.
  29.           The default control dir is /spool/news.
  30.  
  31.  
  32.         nntp directory  old=new
  33.           Establish a newsgroup name mapping, so that a newsgroup name
  34.           beginning with <old> is changed to one beginning with <new>,
  35.           which may be a null string.  To delete a mapping, use <old>==.
  36.           The mapping scan continues until the list is exhausted, in the
  37.           same order the nntp dir commands were specified.
  38.  
  39.               Example:  nntp dir  rec.radio.=
  40.                         nntp dir  amateur.=
  41.                         nntp dir  shortwave=swl
  42.                         nntp dir  equipment=eq
  43.  
  44.               will map rec.radio.amateur.policy to policy, rec.radio.swap
  45.               to swap, rec.radio.shortwave to swl, and
  46.               rec.radio.amateur.equipment to eq.
  47.  
  48.  
  49.         nntp dropserver <nntpserver_host>
  50.           Drop the specified NNTP server from the list of servers to contact.
  51.  
  52.  
  53.         nntp firstpoll [<#days>]                              Default: 5
  54.           Sets or shows the number of days of old news that is requested
  55.           in the initial poll to a new server.
  56.  
  57.  
  58.         nntp groups <group> [<group> ...]             Default: All groups
  59.           Display or set the currently set USEnet newsgroup(s).  The group
  60.           names are separated by spaces or commas.  The '*' and '!'
  61.           metacharacters (meaning 'all' and 'not' respectively) are
  62.           supported.
  63.  
  64.  
  65.         nntp kick <nntpserver_host>
  66.           Kick the local NNTP client to get in touch with the named server.
  67.  
  68.  
  69.         nntp listservers
  70.           List the currently defined servers.
  71.  
  72.  
  73.         nntp lzw <ON | off>
  74.           Turn on or off attempts to request LZW compression be used by
  75.           the server when sending articles.
  76.  
  77.  
  78.         nntp trace <level>                                     Default: 1
  79.           Sets or shows the current trace level for NNTP traffic.
  80.  
  81.           Level
  82.            0:  No tracing.
  83.            1:  Display serious errors only
  84.            2:  Display serious and transient errors
  85.            3:  Display serious and transient errors, plus session progress
  86.            4:  Display serious and transient errors, session progress and
  87.                   actual received articles
  88.            5:  Display errors.
  89.  
  90.  
  91.         nntp quiet <yes | NO>                                 Default: no
  92.           Sets or shows the current arrival-notification setting for NNTP
  93.           traffic.  The notification will include a BEL character if
  94.           "smtp quiet no" is in effect.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.         We now describe the "NNTPS" client/server commands.  Remember
  102.         that the 'start nntp' command must be used to allow the nntp server
  103.         to accept connects from other nntp clients.
  104.  
  105.  
  106.         nntp active
  107.           Displays the active file, which shows configured newsgroups.
  108.           See 'nntp create'.
  109.  
  110.  
  111.         nntp access [on | OFF]
  112.           Displays or sets whether access permissions are enforced.  When
  113.           enabled, the file /spool/news/access is scanned to determine the
  114.           access permissions for a client host.  Each line of this file has
  115.           fields of the form:         host:permissions:
  116.           where host is explicit hostname (FQDN) or starname, eg, *.aara.org
  117.           and permissions are a string of chars: R => read, P => post,
  118.           none=>deny access.  When access is turned on, hosts not mentioned
  119.           are DENIED nntp access.
  120.  
  121.  
  122.         nntp add <nntpserver_host> <interval> [<range>] [<groups>]
  123.           Add an NNTP news server to query every <interval> seconds for new
  124.           articles in the specified <groups>.  If no <groups> are specified,
  125.           all groups found in /spool/news/active are checked.
  126.  
  127.           <range> specifies the time-of-day limits when the queries will be
  128.           made, in the form hh:mm-hh:mm where start time precedes end time.
  129.  
  130.         Multiple 'nntp add' commands may be used to concatenate groups
  131.         (up to a maximum of 512 bytes).
  132.  
  133.         Example:  nntp add news.usl.edu 3600 usl.test,rec.radio.swap
  134.  
  135.  
  136.         nntp create <news.group.name> [y|n]
  137.           Updates the /spool/news/active file, which must have an entry
  138.           for each news group you wish to receive.  Choose y to permit
  139.           posting to this group, or n to deny posting.  y is assumed if
  140.           nothing is specified.  The /spool/news/pointer file is also
  141.           updated with the path to the directory which will contain the
  142.           articles.  Articles will be stored as separate files, named
  143.           by an integer corresponding to their arrival order.
  144.  
  145.  
  146.         nntp drop <nntpserver_host>
  147.           Drop the specified NNTP server from the list of servers to contact.
  148.  
  149.  
  150.         nntp dump <newsgroup> [<areaname>]
  151.           Dump all the news articles in <newsgroup> to the Jnos area
  152.           called <areaname>.  This would allow mailbox users to read news,
  153.           but no provisions are made to dump just new articles.  If
  154.           <areaname> is omitted, then <newsgroup> is used as the area name.
  155.           Note: this command is unavailable if Jnos was compiled with
  156.           NEWS_TO_MAIL #define'd (see note 4 below).
  157.  
  158.  
  159.         nntp firstpoll [<#days>]                              Default: 5
  160.           Sets or shows the number of days of old news that is requested
  161.           in the initial poll to a new server.
  162.  
  163.  
  164.         nntp ihave [<val>]                                Default: 0
  165.           Set or display the IHAVE nntp-protocol behaviour.
  166.           0 => IHAVE disabled (default)
  167.           1 => IHAVE reports only for newsgroups associated with serverhost
  168.           2 => IHAVE reports for all newsgroups
  169.  
  170.          The IHAVE protocol tells the server the message-ids of articles
  171.          stored here;  it is used to forward articles off this system.
  172.  
  173.  
  174.         nntp kick <nntpserver_host>
  175.           Kick the local NNTP client to get in touch with the named server.
  176.  
  177.  
  178.         nntp list
  179.           List the currently defined servers.
  180.  
  181.  
  182.         nntp lzw <ON | off>
  183.           Turn on or off attempts to request LZW compression be used by
  184.           the server when sending articles.
  185.  
  186.  
  187.         nntp post
  188.           Posts to a local newsgroup.  A session is created, and the console
  189.           user is queried for UserName (unless established by a prior 'nntp
  190.           profile' command), Newsgroup, Subject, and message body.  While
  191.           entering the msg, a line consisting of ".u" or ".r" will then
  192.           prompt for a file name, which is inserted into the article being
  193.           built.  "/EX", "***END" or "." will end the article when found alone
  194.           on a line.  When the message body is terminated, the prompt
  195.               [Send, Abort, Exit, List] 
  196.           is displayed.  Enter the first letter of the desired choice.
  197.           Note that Exit quits the post subcommand, while Abort (or Send)
  198.           allows you to post another article.
  199.  
  200.  
  201.         nntp profile {fullname|host|organization|reply|sig|user} string_value
  202.           Profile establishes values for the header fields of posts
  203.           originating here.  Options include:
  204.  
  205.           sig  path_to_signature_file
  206.           host FQDN    Defaults to our 'hostname'
  207.           fullname "First Mi. Lastname"
  208.           organ "organization name desired"
  209.           user "user name"
  210.           reply reply-to-address
  211.  
  212.  
  213.         nntp read <newsgroup> [<article_number>]
  214.           Reads the local <newsgroup>, beginning with the first unread
  215.           article unless <article_number> is also provided.  A session is
  216.           created for displaying the articles.  After each article, a
  217.           prompt "Read next/previous? (n/p/q) " allows the console user to
  218.           easily progress through the articles.
  219.  
  220.  
  221.         nntp quiet [<val>]                               Default: 0
  222.           Dispays or sets the value if the quiet behaviour flag.  Nntp will
  223.           display a message and/or beep when a new article arrives:
  224.           0 => beep only (default)
  225.           1 => beep and display msg
  226.           2 => no msg or beep
  227.  
  228.  
  229.  
  230.         NOTES:
  231.         1. See the 'expire' command for information on removing old articles.
  232.         2. The TO: addresses, when present, are stripped from article headers
  233.            by the NNTP client.  This was done to prevent loops should the
  234.            area be forwarded to another Jnos system, since the TO: address
  235.            would cause the msg to be routed back to the mail-to-news daemon.
  236.            If you want to forward an area, give the TO: address on the line
  237.            in forward.bbs that lists the area.  Example: rec.radio.swl all@swl
  238.         3. The NNTPS software includes a mail-to-news feature, such that email
  239.            with a To: address that begins with "!" is passed to the NNTPS
  240.            module.  The remainder of the To: address is interpreted as a
  241.            newsgroup name, with the name truncated at the first occurence of
  242.            one of "%@.,/", and with "!" translated to ".".  An alias is usually
  243.            used to provide this special name.  For example, to route all ALLUS
  244.            bulletins to both the allus area, and the ampr.allus newsgroup,
  245.            use the alias:  allus  allus  !ampr!allus
  246.         4. The NNTPS software includes a news-to-mail feature, such that news
  247.            articles can be emailed to local or remote destinations after they
  248.            are processed by nntp.  This would allow, for example, emailing to
  249.            a public area, so that BBS users too could read news articles.
  250.            Jnos must be compiled with NNTPS and NEWS_TO_MAIL #define'd and
  251.            a file /spool/news/gateway must exist to define the mapping from
  252.            a newsgroup to an SMTP To: address.  Each non-comment line in the
  253.            gateway file must begin with a newsgroup name (starnames OK),
  254.            followed by spaces or tabs, followed by the email To: address.
  255.            Examples:
  256.                 # comment line
  257.                 rec.radio.swap    sale
  258.                 rec.radio.shortwave    swl
  259.                 rec.radio.amateur.*  ham
  260.  
  261.  
  262.